home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 2010 April / PCWorld0410.iso / hity wydania / Ubuntu 9.10 PL / karmelkowy-koliberek-desktop-9.10-i386-PL.iso / casper / filesystem.squashfs / usr / share / doc / libnet-dbus-perl / README < prev   
Text File  |  2008-02-20  |  4KB  |  134 lines
  1.                  Net::DBus
  2.                  =========
  3.  
  4. Net::DBus provides a Perl XS API to the dbus inter-application
  5. messaging system. The Perl API covers the core base level 
  6. of the dbus APIs, not concerning itself yet with the GLib
  7. or QT wrappers. For more information on dbus visit the 
  8. project website at:
  9.  
  10.   http://www.freedesktop.org/software/dbus/
  11.  
  12. This version operates against DBus 0.33, through 0.60, and 
  13. possibly later versions, if there have been no serious API 
  14. changes.
  15.  
  16. INSTALLATION
  17. ------------
  18.  
  19. To install this module type the following:
  20.  
  21.    perl Makefile.PL
  22.    make
  23.    make test
  24.    sudo make install
  25.  
  26. The makefile calls the C<pkg-config> script to determine the
  27. correct flags to pass to the compiler & linkers when building
  28. the XS part of the module. Thus, ensure pkg-config is in
  29. a directory listed by the $PATH environment. 
  30.  
  31. The pkg-config program will likely find the DBus install in /usr
  32. provided by the base OS distribution, so if testing against an 
  33. alternate  install of DBus, set the C$PKG_CONFIG_PATH env 
  34. variable before generating the Makefile. For example, if your 
  35. dbus installation is in C<$HOME/usr/dbus-cvs-tip> , then to build
  36. and install against this version of DBus do
  37.  
  38.    export PKG_CONFIG_PATH=$HOME/usr/dbus-cvs-tip/lib/pkg-config
  39.    perl Makefile.PL PREFIX=$HOME/usr/dbus-cvs-tip
  40.    make
  41.    make test
  42.    make install
  43.  
  44.  
  45. DEPENDENCIES
  46. ------------
  47.  
  48. In keeping with the C API, the Perl DBus implementation
  49. has minimal external dependancies:
  50.  
  51.   Time::HiRes
  52.   XML::Twig
  53.   XML::Parser
  54.  
  55. And to run the test suite:
  56.  
  57.   Test::More
  58.   Test::Pod (optional, but recommended)
  59.   Test::Pod::Coverage (optional, but recommended)
  60.  
  61. Although they are not part of the base Perl distribution, most 
  62. OS distributor will already provide addon packages containing
  63. these modules. Failing this, they are all available from CPAN
  64. http://search.cpan.org/
  65.  
  66. EXAMPLES
  67. --------
  68.  
  69. There are a number of example programs in the examples/
  70. subdirectory demonstrating use of the high level application
  71. developer APIs.
  72.  
  73.   example-service.pl         - Providing a simple service
  74.   example-client.pl          - Talking to a remote service
  75.   example-signal-emitter.pl  - How to broadcast signals
  76.   example-signal-receiver.pl - How to receive signals
  77.   dump-object.pl             - Dump info about dbus objects
  78.   lshal.pl                   - Dump names of all HAL devices
  79.  
  80. CONTRIBUTIONS
  81. -------------
  82.  
  83. Contributions both simple bug fixes & new features are
  84. always welcome. Please supply patches in context, or 
  85. unified diff format. A simple method to generate such a 
  86. patch is as follows:
  87.  
  88.   * Clean out generated files from your working
  89.     directory:
  90.  
  91.         make distclean
  92.  
  93.   * Rename your working directory to have '-new' 
  94.     extension: 
  95.  
  96.         mv DBus-0.33.3 DBus-0.33.3-new
  97.  
  98.   * Extract a pristine copy of the source:
  99.  
  100.         gunzip -c DBus-0.33.3.tar.gz | tar xf -
  101.         mv DBus-0.33.3 DBus-0.33.3-orig
  102.  
  103.   * Generate the patch:
  104.  
  105.         diff -ruN DBus-0.33.3-orig DBus-0.33.3-new \
  106.           > DBus-0.33.3-[something].patch
  107.         gzip DBus-0.33.3-[something].patch
  108.  
  109.  
  110. Send the resulting to .patch.gz file directly to 
  111. Daniel Berrange <dan at berrange dot com>
  112.  
  113. COPYRIGHT AND LICENCE
  114. ---------------------
  115.  
  116. Copyright (C) 2004-2008 Daniel Berrange
  117.  
  118. Net-DBus may be redistributed and/or modified under the terms of Perl itself.
  119. Either:
  120.  
  121. a) the GNU General Public License as published by the Free
  122.    Software Foundation; either version 2, or (at your option) any
  123.    later version
  124.  
  125. or
  126.  
  127. b) the "Artistic License"
  128.  
  129.  
  130. See the file "COPYING" for the full text of each license
  131.  
  132. -- End
  133.  
  134.